在完成 Python 專案的建立與腳本測試後，程式碼的管理與備份便成為首要任務。Git 是目前軟體開發中最標準的版本控制系統，但在初次將專案納入版控時，最常犯的錯誤就是將「不該追蹤的檔案」全部都提交出去。

特別是上一篇剛建立的虛擬環境資料夾（.venv），裡面包含很多第三方套件二進位檔案，若未妥善排除便推送到遠端倉庫（如 GitHub），將嚴重膨脹儲存庫容量並引發環境相依問題。

本篇將介紹 Git 的基礎環境設定，並實作如何透過 .gitignore 建立乾淨正確的版控規範。

1.哪些檔案「不應該」進版本控制？

• 應該納入版控：
  • 專案原始碼（如 fetch_data.py）。
  • 專案相依清單（如 requirements.txt）。
  • 設定檔範本與專案說明文件（如 README.md）。
• 不能納入版控：
  • 虛擬環境目錄（.venv/、venv/）：這些套件應由其他開發者依據 requirements.txt 自行還原，直接納入會造成容量暴增且跨平台無法執行。
  • Python 快取目錄（pycache/、*.pyc）：執行期間編譯出的位元組碼，屬於暫存檔。
  • 敏感資訊（.env、金鑰檔案）： 包含 API Key、資料庫連線密碼等機密內容。

2.檢查並安裝 Git
多數 Ubuntu 系統已預載 Git，可透過終端機檢查版本

git --version

若未安裝，請執行：

sudo apt update
sudo apt install -y git

3.設定使用者識別
在正式建立 Commit 前，必須設定開發者名稱與電子郵件，Git 會將此資訊記錄在每一筆提交紀錄中：

git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"

可透過以下指令檢查設定是否正確寫入

git config --list 

(按q離開)

4.配置 .gitignore 排除規則
避免誤追蹤環境目錄，應在初始化儲存庫時同步建立 .gitignore 檔案。
(1)確認當前目錄路徑

cd ~/projects/demo_project

(2)建立並編輯 .gitignore
使用文字編輯器於專案根目錄建立配置檔：

nano .gitignore

寫入針對 Python 專案的標準排除規範：

# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# Virtual Environments
.venv/
venv/
ENV/
env/

# Environment variables & secrets
.env

# Editor settings
.vscode/

確認內容無誤後，儲存並退出編輯器。

5.專案版本庫初始化與首次提交
(1)初始化 Git 儲存庫

git init

(2)檢驗檔案追蹤狀態

git status

此時輸出的「未追蹤檔案（Untracked files）」清單中，應該只會看到 ：

• .gitignore
• fetch_data.py
• requirements.txt
  若確認沒有出現 .venv/ 或大量底層檔案，代表 .gitignore 設定已成功生效。
  

(3)暫存並提交

git add .
git commit -m "feat: initial commit with fetch_data script"

|明日目標：掌握了版控與腳本開發後，明天將介紹終端機實用技巧 Alias 配置，學習如何自訂快捷指令大幅精簡日常繁瑣的重複操作。|